.. _ecmSxCfg_ExtStop_SetOfsDistMode:

ecmSxCfg_ExtStop_SetOfsDistMode
===============================
-------------------------------


SYNOPSIS
--------


.. code-block:: none

  t_success  ecmSxCfg_ExtStop_SetOfsDistMode(
    t_i32  NetID,
    t_i32  Axis,
    t_bool  IsHardOfsDistMode,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- ecmSxCfg_ExtStop_SetEnv2 함수와 ecmSxCfg_ExtStop_SetEnv3 함수의 OfsDist인자(거리오프셋)의 적용모드를 설정합니다.



PARAMETER
---------


- NetID : Network 번호

- Axis : 대상 축 번호.

- IsHardOfsDistMode : PTP이송(이송거리가 정해진 이송) 모드에서 거리오프셋이 적용되는 모드를 설정합니다.

+-------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------+
| Value | Meaning                                                                                                                                                                     | Default |
+=======+=============================================================================================================================================================================+=========+
| 0     | 연성(Soft) 모드: 센서가 감지된 이후에 미리 정해진 거리오프셋(OfsDist)보다 목표좌표에 먼저 도달하면 해당 목표좌표에서 이송을 종료합니다.                                     |         |
+-------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------+
| 1     | 강성(Hard) 모드: 센서가 감지된 이후에 미리 정해진 거리오프셋(OfsDist)보다 목표좌표에 먼저 도달하더라도 해당 목표좌표는 무시되고, 정해진 거리오프셋만큼을 무조건 이송합니다. | Y       |
+-------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------+

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.





RETURN VALUE
------------


- 함수 수행의 성공 여부를 반환합니다.


+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+